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1. About MacPPP 


MacPPP is a Macintosh implementation of PPP, the Point-to-Point Protocol, which allows you to 
use TCP/IP (Transmission Control Protocol/Internet Protocol) over asynchronous serial lines. 
MacPPP makes it possible for your Mac to act as a host on the Internet, and, therefore, as a peer 
with other host computers around the world. This means that you can use telnet, FTP, Gopher 
and WAIS clients, and other services directly from your Macintosh. 

To use MacPPP, you must be dialing into a terminal server that is capable of supporting PPP, 
such as a Merit/MichNet Secondary Communications Processor. 

MacPPP works with applications that use MacTCP, such as NCSA Telnet and VersaTerm 4.6 and 
higher. MacTCP is Apple's control panel device that provides a standard network interface for 
TCP/IP applications. 

MacPPP 1.1 is a Line Access Protocol (LAP mdev) driver for MacTCP. This version does not 
support AppleTalk over PPP. 

MacPPP requires MacTCP 1.1 or higher, Macintosh System 6.0.5 or higher, and a Hayes- 
compatible modem for dial-in connections. You can also use MacPPP over hardwired, 
asynchronous connections, but the University of Michigan discourages the use of these 
connections in favor of connections to Ethernet local area networks. 

Note that using the TCP/IP protocols adds a certain amount of overhead to your communications 
sessions. The additional overhead isn’t a problem when you are working at higher 
communications speeds, but may slow down communications considerably with slower modems, 
or when you are using certain software applications. 


2. Getting Started 

Once you have finished installing and configuring MacPPP, as described below, your dial-in 
TCP/IP sessions will be handled automatically. You'll simply click on the 'Open PPP' button on 
the Config PPP Control Panel or start up a software application that uses MacTCP. Your modem 
will dial automatically. You can then enter your password and proceed with your dial-up session. 

To configure MacPPP, you must change several settings on the Config PPP control panel and the 
Configure Server dialog box. If you are a MichNet user, you may also want to enter your 
authorization code in the Authorization dialog box. All the other settings are optional. 

2.1 Copying MacPPP to Your Macintosh 

MacPPP is available for anonymous FTP on the host merit.edu in the file: 

/pub/ppp/macpppl . 1 . hqx 

This file is stored in an archived and compressed format, and must be decompressed after you 
copy it to your Macintosh. The file /mac/OOintroduction on the host mac.archive.umich.edu 
explains how to decompress the file. 
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Once decompressed, MacPPP consists of a System Extension with the filename 'PPP' and a 
control panel device with the filename 'Config PPP'. On System 7.0 machines, these files should 
go in the Extensions and Control Panels folders, respectively. Once you have opened the Config 
PPP control panel, MacPPP will create a file called 'PPP Preferences' in the Preferences folder. 
The PPP Preferences file is required for the PPP LAP driver. 

On System 6.x machines, the 'PPP' and 'Config PPP' files should go in the System folder. Once 
you have opened the Config PPP control panel, MacPPP will create a file called 'PPP Preferences' 
in the System folder. 

After you have installed the system extension and the control panel, reboot your machine. 

2.2 Documentation 

Four documentation files are also available on merit.edu. The first file, 'changes,' contains 
information on changes included in the latest version of MacPPP. The second file, 
/pub/ppp/macppp.txt, contains an ASCII (plain text) version of the document you're reading now. 
Two PostScript versions of the document you're reading now are also available. The file 
/pub/ppp/macppp.ps.hqx is stored in an archived and compressed format, and must be 
decompressed after you copy it to your Macintosh. The file /mac/OOintroduction on the host 
mac.archive.umich.edu explains how to decompress the file. The file macppp.ps.Z contains a 
PostScript version of the documentation in a compressed Unix format. 


3. Configuration 

Follow the steps below to configure MacPPP. Once you've completed configuration, you can 
begin your PPP session either by clicking on the 'Open PPP' button on the Config PPP Control 
Panel or by launching an application that uses MacTCP. 

1. On System 7.0 machines, select the MacTCP control panel icon and click on 'More ...' On 
System 6.x machines, under the Apple Menu, select 'Control Panel.' Then select MacTCP 
from the control panel window, and click on 'More ...' 

Set up MacTCP for server addressing by selecting “server” under “Obtain Address”. Do not 
select dynamic or manual (static) addressing. In most cases, the local terminal server will 
assign you a TCP/IP address. Click on the 'OK' button to save your changes. You do not 
need to enter a gateway or TCP/IP address. 

If for some reason you need to statically assign an IP address, use MacPPP's IP Control 
Protocol (IPCP) option button on the Configure Server dialog box. Note, however, that PPP 
will not open the connection if the terminal server is not willing to negotiate the address you 
have selected. In general, it is preferable to let the terminal server provide the IP address by 
leaving the address at the default setting, 0.0.0. 0, in the IPCP dialog box. 

2. Select the PPP icon in the MacTCP control panel. 

3. On System 7.0 machines, select the Config PPP control panel icon. On System 6.x 
machines, under the Apple Menu, select Config PPP from the control panel window to bring 
up the Config PPP control panel. 
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3.1 Config PPP Control Panel 

The Config PPP Control Panel leads to several dialog boxes and windows that you'll use to 
configure MacPPP. 


Control Panel 


£_l 


h-> 


General 

■ft 

Brightness 


Flash- It 3.0.2 


K> 


3.3.3 


©m 3 [ Open PPP 

P PP - k —* Stats. 

DOWN [ PPP 1 


Port Name: | Modem Port ^ | 

Idle Timeout (minutes): None ▼) 
Echo Internal (seconds): ] Off ^ | 

□ Terminal Window (•JTone dial 

□ Hangup on Close G Pulse dial 

PPP Seruer: | Untitled ▼ | 

[ Configure seruer... 


Vi .1 


The figure above shows how the Config PPP control panel looks when you first open MacPPP. 
You can use the control panel to begin and end your PPP sessions. The only parameters you need 
to set are the Port Name and your phone type — tone dial or pulse dial. To enter the phone 
number you want to dial, go to the Configure Server dialog box. described in section 3.2. 

Other parameters can also be used to customize MacPPP. These optional settings are described 
below. 

PPP Up/Down 

This icon indicates the current state of the driver — more specifically, the PPP IP Control 
Protocol. 'Open' indicates that PPP is ready for IP traffic. 'Down' indicates that it is not yet 
ready for TCP/IP traffic. 

Open/Close PPP 

Click on these buttons to open and close your PPP session, once you've configured MacPPP. 

Click on 'Close' to close your PPP session if you want to use your serial port to run a 
traditional asynchronous program, such as a terminal emulator. Click on 'Open' to manually 
re-open your PPP session in order to use PPP again. 

Statistics 

When you click on this button, a dialog box with a set of counters appears. Click on the 
Update button on the Statistics dialog box to show the current value of the counters and the 
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current state of all supported PPP options. These options are documented in the PPP RFCs 
(e.g., RFC 1331). The RFC (Request for Comment) series is available for anonymous FTP 
on the host nic.merit.edu in the /documents/rfc directory. 

Most users will not need to use the Statistics dialog box. 

Port Name 

The Port Name pop-up menu allows you to select the modem port, printer port, or any other 
serial ports registered with the Communications Toolbox. (The Communications Toolbox is 
included with System 7.0, and optional on System 6.x machines.) On some Macintoshes with 
an internal modem, you'll only be presented with an “internal modem” option on the pop-up 
menu. 

The default is the modem port. If you have registered other ports, MacPPP will use the 
Communications Toolbox to automatically obtain their names and the names of associated 
drivers. 

Idle Timeout (minutes) 

You can use the Idle Timeout pop-up menu to configure MacPPP so that if your PPP session 
remains idle for a specified amount of time, MacPPP will bring up an alert box asking you if 
you want to close the session. You can either close the session or ignore the message. 

Leave the setting at None, the default, if you don't want to set a timeout interval. If you want 
to set a timeout interval, click on the pop-up menu and select a timeout interval from 5 to 120 
minutes. 

Echo Interval (seconds) 

MacPPP uses a PPP packet called the “LCP (Line Control Protocol) echo request” to 
determine if your connection has been dropped. MacPPP sends the requests at the interval 
you specify; if the terminal server does not respond after 3 successive requests, MacPPP 
assumes that the link is down. 

If you leave the Echo Interval pop-up menu set off — the default — MacPPP will not send out 
any echo requests. If you want MacPPP to send out echo requests, click on the pop-up menu 
to specify the interval at which MacPPP should send out echo requests — from 2 to 20 
seconds. 

Terminal Window 

Click on this box to bring up a basic terminal emulator, which will appear when MacPPP is 
connecting with the local terminal server. You can then use the terminal emulator to 
manually type any commands needed to put the terminal server into PPP mode. Once you 
have entered these commands, click the 'OK' button to start your PPP session. 

If you click on the Terminal Window box, MacPPP will ignore the Phone number and 
Modem init fields in the Configure Server and Connect Script dialog boxes. 

Currently, the terminal emulator offers only basic features, and does not provide a cursor or 
scroll bar. Most users will not need to use the MacPPP terminal emulator. 
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Hangup on Close 

If this box is checked, MacPPP will send the modem a hangup string (+++ ATH) when you 
close your PPP session. 

Tone/Pulse Dial 

Click on the 'Tone dial' or 'Pulse dial' button to select your type of phone service. 

PPP Server 

See the next section for information on this feature. 

3.2 Configure Server Dialog Box 

Click on 'Configure server' in the Config PPP control panel to display the Configure Server 
dialog box, shown below. 


PPP Seruer Name: 


MichNet 


| Add Seruer | | Delete Seruer J 
Port Speed: 9600 
□ CTS Flow Control 


Phone num 
Modem Init 


747-3400 


Modem connect timeout: 



seconds 


[ Connect Script..! - ] [ LCP Options... ] 
| Ruthentication..r] [ IPCP Options.. . ) 


[ Done ] 


The only parameter you need to set on the Configure Server dialog box are 'Phone number' and 
'Port Speed.' If your modem defaults are set up correctly, you can ignore the 'Modem Init' field. 

If the defaults are not set up correctly, you'll need to enter a modem initialization string, as 
described below. To enter the information needed to identify you to the terminal server, go to the 
Authentication dialog box, described in section 3.4. 

Several optional parameters can also be set on the Configure Server dialog box. In the figure 
above, 'MichNet' has been selected as the PPP Server Name. The port speed is 9600 bps, and the 
phone number is MichNet's Ann Arbor 9600 bps dial-in number. 

PPP Server Name 

This convenient feature allows you to set up a separate configuration for each host you access 
with MacPPP, assign a name to that host, and connect to it by selecting its name on a pop-up 
menu. 
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Click on the 'Add Server' button to add a new server. Next, enter the server name — MichNet 
in the figure above — and configure any desired options. The name will then be displayed in 
the PPP Server box on the Config PPP control panel. 

Once you've finished adding servers, you can connect to any of them by clicking on the PPP 
Server pop-up menu on the Config PPP control panel and selecting the host you want to 
access. MacPPP will automatically establish a connection using the configuration you 
specified. 

Click on the 'Delete Server' option button to delete server entries. 

Port Speed 

Enter the baud rate for the port being used for your PPP session. 

CTS (Clear To Send) Flow Control 

Click on this box if you want MacPPP to use CTS for output flow control. CTS flow control 
allows a modem to run at the higher speeds provided by data compression. Your modem is 
responsible for providing the CTS signal. 

Currently, MacPPP does not support input flow control through RTS or XON/XOFF. Be 
sure that your modem is not using XON/XOFF flow control on input or output. If 
XON/XOFF flow control is enabled by default, check your documentation and use the 
appropriate modem initialization string in the Configure Server dialog box to disable it. 

Phone number 

Click on this box to enter the phone number of the host you're dialing. Several MichNet dial- 
in numbers are listed at the end of this document. 

Modem Init 

Click on this box to enter any initialization strings required by your modem. The string must 
be a Hayes 'AT' command. If your modem defaults are set up correctly, you may not need to 
enter a Modem Init string in order to use PPP. 

The Modem Init string is typically used to: 

• Disable XON/XOFF flow control 

•Enable CTS flow control, if your modem supports it 

MacPPP does not support XON/XOFF flow control. Be sure that your modem is not using 
XON/XOFF flow control on input or output. If XON/XOFF flow control is enabled by 
default, check your documentation and enter the appropriate modem initialization command 
in the Configure Server dialog box to disable it. 

CTS flow control allows a modem to run at the higher speeds provided by data compression. 
Your modem is responsible for providing the CTS signal. 

If you enter a Modem Init string but the phone number field is not set (either because you are 
not using a modem, or prefer to issue the dial command yourself), MacPPP will not send the 
Modem Init command. 
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If the phone number field is set, MacPPP will automatically send the initialization command 
'AT E0V1' to the modem. This will disable echoing and put the modem in verbose response 
mode. An 'OK' response is expected from the modem. If you have not entered an additional 
modem initialization command in the Modem Init box, the phone number will then be dialed. 

If you have entered a modem initialization command in the Modem Init box, the command 
will be sent to the modem after the 'AT EOV T command. MacPPP will again expect an 'OK' 
response from the modem. After MacPPP receives an 'OK' response, the phone number will 
be dialed. You may include any characters in the phone number that your modem will 
accept, e.g., a comma (,) for a pause between numbers. 

Modem connect timeout 

By default, MacPPP will wait up to 90 seconds for a response from the modem before timing 
out. If it receives a CONNECT response, MacPPP will proceed to the next phase. If a 
BUSY response is received, MacPPP will attempt to redial. Click on the Modem connect 
timeout box to change the timeout interval; you can select any number of seconds. 

Click on the option buttons on the bottom of the 'Configure server' dialog box to bring up the 
Connect Script, Authentication, and LCP/IPCP dialog boxes. 

3.3 Connect Script Dialog Box 

The figure below shows how the Connect Script dialog box looks when you first open MacPPP. 
If you are dialing into a Merit/MichNet SCP, you do not need to enter any information in the 
Connect Script dial box. The SCP will automatically sense that you are initiating a PPP session; 
you will not need to supply a 'PPP' string to the SCP. 


Wait timeout: 

40 

seconds 





<CR> 

® Out O Wait 


□ 

® Out O Wait 


□ 

® Out O Wait 


□ 

® Out O Wait 


□ 

® Out O Wait 


□ 

® Out O Wait 


□ 

® Out O Wait 


□ 

® Out O Wait 


□ 



[ Cancel ] ( OK ] 


If you prefer to use the Connect Script dialog box, you can enter up to eight dialog strings to 
establish the connection. All of these fields are optional. Once you've established a 
connection, your modem and the terminal server will exchange information contained in the 
dialog strings to initiate your PPP session. 

Select the Out button in front of the seven dialog strings to indicate that your modem should 
send out the string. Select the Wait button to indicate that the string is expected to be 
received from the terminal server. Control characters can be entered using the A (caret) 
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convention, e.g., ' A m' for a carriage return. The <CR> check boxes indicate that a carriage 
return should be appended to the end of the dialog string. Placing a ' A m' at the end of the 
string also appends a carriage return to the end of the dialog string. 

The backslash (\) is a reserved character in the Connect Script dialog box. It can be used as 
follows for both Out and Wait strings: 


\r 

carriage return 

\ A 

literal ' A ' 

\\ 

literal 'V 

\nnn 

8 -bit octal value 


The following can be used only in Out strings: 


\b 

send a break (TOO 
milliseconds) 

\d 

delay for one second 

\t 

invoke the MacPPP 
terminal emulator 


Wait timeout (seconds) 

Click on this box to enter the number of seconds MacPPP will wait for each 'wait' string to be 
received from the local terminal server. The default is 40 seconds. By default, if more than 
40 seconds elapse, MacPPP will abort the attempt to establish a connection. An alert box will 
appear, asking if you want to quit MacPPP or retry the connect script from the beginning. 


12 • Merit Network 


June 1993 





Installing MacPPP 


3.4 Authentication Dialog Box 

The figure below shows how the Authentication dialog box looks when you first open MacPPP. 
The only information you need to enter is your authorization ID (authorization code). 


Note: The password and id fields may 
be left blank to indicate that they are 
to be entered at connect time. 


Ruth. ID: 
Password: 


UELfl/1 234 


Retries: 


10 


Timeout: 



seconds 


r 1 

Cancel 


OK 


Authorization ID and Password 

Use the Authentication dialog box to enter the information needed to identify you to the 
terminal server. If you have an authorization code, enter it here. If you don't know what an 
authorization code is, enter HELP at the Merit/MichNet “Which Host?” prompt to access 
MichNet' s free Online Help System. Select 'ACCESS Information,' and then 
'AUTHORIZATION server information.' 

Authorization codes comprise the host name, a forward slash, and your userlD. For example, 
if you are a user at Oakland University and your userlD is 1234, your authorization code 
would be VELA/ 1234. 

If you would like to obtain an authorization code, check with the computing center at your 
institution to see if it can provide one for you. If it cannot, send e-mail to acctmgr@merit.edu 
or call the MichNet Accounts Manager at (313) 764-9430. 

Merit/MichNet recommends that you do not enter your password in the Authentication dialog 
box, even though your password will be blanked. Instead, leave this box blank — you'll be 
prompted for your password once you've connected to the local terminal server. 

Retries 

Click on this box to specify how many times MacPPP should attempt to resend your ID 
and/or password, if it is unable to establish a connection with the local terminal server. The 
default is 10 retries. By default, MacPPP will abort the attempt to establish a connection after 
10 retries. 
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Timeout (seconds) 

Click on this box to enter the number of seconds MacPPP should wait for the terminal server 
to respond to your ID and/or password authentication request. You can enter any number of 
seconds; the default is 3 seconds. 

3.5 LCP and IPCP Options Dialog Boxes 

The LCP (Line Control Protocol) and IPCP (IP Control Protocol) Options dialog boxes allow you 
to configure the options that PPP negotiates with the local terminal server. In most cases, the 
defaults should work. Changing them is not recommended unless you are familiar with several of 
the documents about PPP in the Internet “Request for Comment” (RFC) series (RFC 1331, 1332, 
and 1334). The RFCs are available for anonymous FTP on the host nic.merit.edu in the 
/documents/rfc directory. 


4. MichNet Dial-in Numbers 


You cannot use MacPPP on the current Ann Arbor 19,200 bps dial-in lines. XON/XOFF is set on 
by default on these modems, and MacPPP does not support XON/XOFF flow control. 

Here are the Ann Arbor dial-in numbers that support PPP: 


1200 bps (Bell 212A compatibles such as the Hayes smartmodem) 763-6520 

2400 bps (Y.22 bis compatibles) 764^-800 

9600 bps (V.32 compatibles) 747-3400 


MichNet's free Online Help System provides a complete listing of MichNet access phone 
numbers. To access the help server, simply enter HELP at the “Which Host?” prompt and select 
'ACCESS information.' 
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